package com.retail.user.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.retail.user.dto.UserQueryDTO;
import com.retail.user.dto.UserVO;
import com.retail.user.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 用户Mapper接口
 * 
 * @author retail-platform
 * @since 2024-09-25
 */
@Mapper
public interface UserMapper extends BaseMapper<User> {

    /**
     * 分页查询用户列表
     * 
     * @param page 分页参数
     * @param queryDTO 查询条件
     * @return 用户列表
     */
    IPage<UserVO> selectUserPage(Page<UserVO> page, @Param("query") UserQueryDTO queryDTO);

    /**
     * 根据用户ID查询用户详情（包含角色信息）
     * 
     * @param userId 用户ID
     * @return 用户详情
     */
    UserVO selectUserWithRoles(@Param("userId") Long userId);

    /**
     * 根据用户名查询用户
     * 
     * @param username 用户名
     * @return 用户信息
     */
    List<User> selectByUsername(@Param("username") String username);

    /**
     * 根据邮箱查询用户
     * 
     * @param email 邮箱
     * @return 用户信息
     */
    User selectByEmail(@Param("email") String email);

    /**
     * 根据手机号查询用户
     * 
     * @param phone 手机号
     * @return 用户信息
     */
    User selectByPhone(@Param("phone") String phone);

    /**
     * 更新用户最后登录信息
     * 
     * @param userId 用户ID
     * @param loginIp 登录IP
     * @return 更新行数
     */
    int updateLastLoginInfo(@Param("userId") Long userId, @Param("loginIp") String loginIp);
}
